home *** CD-ROM | disk | FTP | other *** search
SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD)))) SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD)))) NNNNAAAAMMMMEEEE snapshot - save a portion of the screen in an image file SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ////uuuussssrrrr////ssssbbbbiiiinnnn////ssssnnnnaaaappppsssshhhhooootttt [[[[----bbbb]]]] DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN _s_n_a_p_s_h_o_t reads an area of the screen specified by the user, and saves it in an image file. To use _s_n_a_p_s_h_o_t, place the _s_n_a_p_s_h_o_t button window someplace other than where you wish to grab. Then, with the input focus attached (i.e. the mouse is inside the _s_n_a_p_s_h_o_t window), hold down a modifier key (shift, ctrl) on the keyboard to maintain the input focus, and move the mouse to one of the four corners of the section of the screen you wish to save. Now press lllleeeefffftttt mouse and continue holding it down while you stretch out a red rubberband to the opposite corner of the area of interest. To tell _s_n_a_p_s_h_o_t to make the image file, go back to the _s_n_a_p_s_h_o_t window, press the rrrriiiigggghhhhtttt mouse and choose one of the two "Save" menu items. You can repeat this sequence in various ways until such time as you wish to exit. At this point, you can choose one of the two exit menu items with the rrrriiiigggghhhhtttt mouse. To move the _s_n_a_p_s_h_o_t window itself, use your favorite window manager accelerator functions, such as ALT+F7. LLLLeeeeffffttttmmmmoooouuuusssseeee ffffuuuunnnnccccttttiiiioooonnnnaaaalllliiiittttyyyy The lllleeeefffftttt mouse button stretches, reshapes, moves or starts an entirely new rubberband for you. The cursor is the constant visual indicator of what will happen if you press lllleeeefffftttt mouse. As long as your input focus is directed to _s_n_a_p_s_h_o_t you will see one of 4 different cursor types depending on the location of the mouse: ccccaaaammmmeeeerrrraaaa ccccuuuurrrrssssoooorrrr ---- will appear when you are on top of any area of the console screen other than on the sides or inside of the rubberband area of interest. ccccoooorrrrnnnneeeerrrr ccccuuuurrrrssssoooorrrr ---- will appear when you are in the immediate vicinity of one of the 4 corners of the currently placed rubberband. hhhhoooorrrriiiizzzzoooonnnnttttaaaallll////vvvveeeerrrrttttiiiiccccaaaallll ccccuuuurrrrssssoooorrrr ---- will appear when you are in the immediate vicinity of one of the 4 sides of the currently placed rubberband. mmmmoooovvvveeee ccccuuuurrrrssssoooorrrr ---- will appear when you are fully inside the rubberband area. When your cursor is anywhere other than on top of the _s_n_a_p_s_h_o_t window, whichever of the four cursors you see will tell you what will happen at that point if you press the lllleeeefffftttt mouse button: if you see the ccccaaaammmmeeeerrrraaaa cursor this means that by pressing the lllleeeefffftttt mouse, you will start creating a new rubberband that you can stretch out in any direction which will stop when you let go of the mouse button; when you see either the hhhhoooorrrriiiizzzzoooonnnnttttaaaallll, vvvveeeerrrrttttiiiiccccaaaallll, or ccccoooorrrrnnnneeeerrrr cursors this means that pressing lllleeeefffftttt mouse at this time will enable you to stretch the corner or side of interest and continue doing so until you release the mouse button; when PPPPaaaaggggeeee 1111 SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD)))) SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD)))) the mmmmoooovvvveeee cursor is visible (while inside of the rubberband), pressing lllleeeefffftttt mouse at this point enables you to move the entire rubberband in its current shape and size until you let go of the mouse. When you see the mmmmoooovvvveeee cursor, you may also press mmmmiiiiddddddddlllleeee mouse to move the rubberband. To pop the _s_n_a_p_s_h_o_t button window, press down the lllleeeefffftttt mouse button while your cursor is on top of the window, and release it without moving more than one pixel in any direction. PPPPoooopppp----uuuupppp MMMMeeeennnnuuuu ooooppppttttiiiioooonnnnssss Snapshot uses the gl command ffffuuuullllllllssssccccrrrrnnnn(((()))) which has some "humorous" side effects. One of them is that unless the cursor is on top of the actual window for the graphics program (in this case, the _s_n_a_p_s_h_o_t button window), pressing rrrriiiigggghhhhtttt mouse will NOT bring up that program's menu. Thus, to access the pop-up menu options, you must always bring the cursor back on top of the _s_n_a_p_s_h_o_t button window before pressing rrrriiiigggghhhhtttt mouse to access _s_n_a_p_s_h_o_t's pop-menu. The pop-up menu currently has five items defined: +o The first item reads SSSSaaaavvvveeee ssssccccrrrrnnnn aaaassss ssssnnnnaaaapppp....rrrrggggbbbb if you have just started up _s_n_a_p_s_h_o_t and have not yet swept out a rubberband. This will create an image file of the entire console screen (notice that at this point there is a red rubberband that encloses the entire console screen). Or else it will read SSSSaaaavvvveeee aaaassss ssssnnnnaaaapppp....rrrrggggbbbb indicating that a rubberband area of interest currently exists. +o The second item--NNNNeeeewwww ffffiiiilllleeee nnnnaaaammmmeeee--will throw up a squat rudimentary textport prompting you to input a new output image file name. If, after having called up the textport, you decide you don't want to change the output image file name, simply pressing carriage with an empty string will exit the textport and not change the filename. +o The third item--IIIIppppaaaasssstttteeee ssssnnnnaaaapppp....rrrrggggbbbb--allows you to paste up the image you have most recently made. Notice that after you have swept out some sub-section of the screen with the red rubberband, but before you have yet selected SSSSaaaavvvveeee aaaassss ssssnnnnaaaapppp....rrrrggggbbbb, the IIIIppppaaaasssstttteeee entry shows up as a grey color instead of the solid black of the other menu items. This is because you have not yet created the actual image file-- hence there is nothing for ipaste to lock on to out in the IRIS universe. Once you have chosen SSSSaaaavvvveeee aaaassss ssssnnnnaaaapppp....rrrrggggbbbb, then when you pop-up the menu again, you will see that the IIIIppppaaaasssstttteeee menu item is now solid black indicating that ipaste now has a fix on the currently saved image file you have created. The same thing will happen after you have selected NNNNeeeewwww ffffiiiilllleeee nnnnaaaammmmeeee but before you save an image into it. Notice that ipaste(1G) now recognizes the EEEEsssscccc key as a short-cut to closing the ipaste image window. This is especially useful when ipaste is called with the ----nnnn option--as _s_n_a_p_s_h_o_t uses it--since there is no border to specify a call to exit from. PPPPaaaaggggeeee 2222 SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD)))) SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD)))) +o The fourth item--RRRReeeeddddrrrraaaawwww RRRRuuuubbbbbbbbeeeerrrrbbbbaaaannnndddd--will redraw the rubberband. This is usefull for when something else erases the rubberband. +o The fifth item--SSSSaaaavvvveeee aaaannnndddd EEEExxxxiiiitttt--will save whatever you currently have selected, and then exit the program. +o The sixth item--EEEExxxxiiiitttt--will simply exit the program without saving anything that may be currently defined to be _s_n_a_p_s_h_o_ted. NNNNOOOOTTTTEEEESSSS There is a window constraint that affects _i_p_a_s_t_e(_1_G) which users of _s_n_a_p_s_h_o_t will run into: under 4Dwm, the minimum _i_p_a_s_t_e window width is now constrained to be 88 pixels. See the _i_p_a_s_t_e(_1_G) man page for more details about why this is so. On machines having less than 24 bits available for RGB display, the displayed image may appeared to have lost some quality. This occurs when the image that was saved was in colormap mode. The pixel color index is expanded into the full RGB information. When redisplayed, the RGB information is dithered on these machines to approximate the original image. When you have selected the SSSSaaaavvvveeee ............ aaaassss ............ pop-up menu item and _s_n_a_p_s_h_o_t is busy reading pixels, the cursor will change to an hourglass until this proces s is finished. Another visual cue (in case you move the cursor elsewhere and let go of the input focus) is that the word "Snapshot" that is written on top of the _s_n_a_p_s_h_o_t button window--which is normally WHITE--turns to RED for the duration of the pixel reading/image file building sequence. It reverts to WHITE when the image file is completed. The ----bbbb option includes a bell-ringing audio cue which will then ringbell with a short duration upon completion of every SSSSaaaavvvveeee operation. The text string "snapshot" which appears in the _s_n_a_p_s_h_o_t button window will always turn RED when an image file is being created, and return to WHITE when finished, but the ----bbbb ring-the-bell option was included for those wishing to be more forcefully appraised that _s_n_a_p_s_h_o_t is ready for more input action. Regarding what is actually saved into your image file, the pixels that are underneath the red rubberband are NOT grabbed by _s_n_a_p_s_h_o_t. This means that where specific pixel boundaries are critical, you must be sure that what you want to make into an image file is exactly inside the red rubberband--but not underneath these red border lines. The one exception to this is when the program is first invoked. As mentioned above, _s_n_a_p_s_h_o_t starts up with the default red rubberband set to the full console screen. In this case, if you select SSSSaaaavvvveeee ssssccccrrrrnnnn aaaassss ssssnnnnaaaapppp....rrrrggggbbbb, the red rubberband will first disappear, then an image file of size XMAXSCREEN by YMAXSCREEN will be created, and finally the red rubberband will reappear. PPPPaaaaggggeeee 3333 SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD)))) SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD)))) BBBBUUUUGGGGSSSS It is possible under extreme circumstances to get fragments of the red outline to remain on the screen. If this happens, place the red rubberband over the fragments and then move the rubberband again. _s_n_a_p_s_h_o_t makes use of the fullscrn() GL command which, as the Reference Manual warns, must be used "with caution or a sense of humor." In this case, caution is advised: when wishing to access the pop-up menu, not only must your cursor be moved back on top of the _s_n_a_p_s_h_o_t button window, but to work as intended, you must release whichever key on the keyboard you have been holding down to maintain the input focus while the cursor has been outside of this button window. Not releasing said keyboard button will produce "humor[ous]" results when playing with the pop-up menu. Another side effect of using fullscrn() while drawing the rubberband in the overlay or popup planes is collision with other utilities also using the overlay or popup planes. To restore the snaphot rubberband, select "Redraw Rubberband" from the popup menu. _s_n_a_p_s_h_o_t is not yet smart enough to make sure there is enough free space on the disk partition from where _s_n_a_p_s_h_o_t itself was originally executed, before it blindly goes off and attempts to allocate enough memory to build an image file of the area you specify. Hence, if you find that an image that you paste up on the screen looks "funny", run DF(1) to first confirm that the disk partition that _s_n_a_p_s_h_o_t is running on has not had all of its "avail" space used up. PPPPaaaaggggeeee 4444 
